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OVERVIEW 

Two examples of local AWIPS applications that create graphical overlays interactively are 
presented here: 

1) Anvil Threat Corridor Forecast Tool (Anvil Tool) using shapeftes 

2) AMU T rajectory Map Maker (T rajectory Tool) using DGM files 


ANVIL THREAT CORRIDOR FORECAST TOOL 

• Purpose Create a graphical overlay that depicts the location of thunderstorm anvils 1. 2, and 3 hours into the future 

• Users Since 2002, the 45th Weather Squadron at Cape Canaveral Air Force Station and Spaceflight Meteorology Group 
at Johnson Space Center have used the tool in the Meteorological Interactive Data Display System (MIDDS) The Applied 
Meteorology Unit (AMU) ported the tool over to AWIPS in 2007. 


SHAPEFILE PROPERTIES 

• Shapeftes are used by the National Weather Service (NWS) to view background maps in 
AW PS They are also a source of data for creating geographic entity lookup tables 
(GELT), used by Wamgen to describe areas under a warning, watch, or advisory 

• NWS offices usually obtain Shapeftes from the AWPS map database 
(htto^/www.nws noaa .oov/Qeodata ) and rarely modify or create their own maps. 

• Shapeftes can be created or modified with GIS software (e g ArcGIS). third-party 
software libraries (e g Shapefte C Library), or a custom program 

• A shapefile stores the geometry and attribute information of the spatial features in a data 
set The geometry for each feature is stored as a set of vector coordinates The feature 
can be a point, polyline, or polygon 

• A shapefile contains a main fte. index fte. and a dBASE table 

- The main Tile contains a record for each spatial feature (e g counties shp) 

- The index file contains the offset of each record from the beginning of the main file 
(e g counties shx) 

- The dBASE table contains records for each attribute (e g counties dbf) Attributes 
are commonly used to describe or label spatial features 

• Each point in a shapefile is represented by two double-precision coordinate values, in the 
order X Y. where X represents longitude and Y represents latitude 

• A polygon consists of one or more rings A ring is a sequence of four or more connected 
points that form a closed loop The first and last vertex of a ring must be the same 

• A polyline is an ordered set of vertices and consists of one or more parts 


An AWIPS display showing thrss 
shapefile* cities Interstate 
highways, and stats/county 
boundaries. The cities shapefile 
consists of points, the interstates 
shapefile consists of polylines and 
the state/county boundaries 
shapefile consists of polygons 


DGM FILE PROPERTIES 

• The Denver AWIPS Risk Reduction and Requirements Evaluation (DARE) Graphics 
Metafile (DGM) was created speoficaly for AWIPS and is not as well-known 

• DGM ftes are binary and contain a series of commands stored in two-byte integers 

• The command to set the drawing color is ignored by AWIPS 

• With the exception of color tables. AWIPS graphics colors can only be changed manualy 
in the D2D application Color tables are used for the 'deep graphic" displays, such as 
profiler time-height displays Deep graphics cannot be overlaid onto images or have 
graphics loaded on top of them 

• Each DGM command is represented by a unique "opcode' in hexadecimal format 

• Most useful DGM commands: 



According to a 2002 AMU study, the following properties of the graphical overlay are consistent with the characteristics of 
anvil clouds over Florida and adjacent coastal waters 

- 10- and 20-n mi radius standoff circles, centered at the forecast location 

- 30-degree sector width (In the AMU study, the standard deviation of the difference between upper-tropospheric wind 
direction and anvil orientation was 25 degrees) 

- Anvil orientation is given by the 300 to 150 mb average wind direction. 

- 1-. 2-, and 3-hour arcs in the upwind direction. 

- Arc distances are calculated from the 300 to 150 mb average wind speed 
Tool creates polygon features, using utilities in the Shapefile C Library (Shapelib) 



- Download Shapelib distribution fte. shape kb- 1 2.10 tar gz. from httoV/dl maotnols oro/dl/shanelih/ Unzjj and untar the 
fte in the /usr/local directory on the AWIPS workstation Build the Shapelib software according to README fte inside 
the distribution file 

- Create soft links in the /usr/local/bin directory to the Shapelib utilities in the /usr/local/shapelib/ directory. 

- Create a new directory for the tool: /awips/fxa/awipsusr/AnvilTool 

- Add the tool to the $FXA_HOME/data/applnfo txt localization file 

- Add an application product button to the dataMenus txt localization file 

- In the backgroundMenus txt localization file, add a submenu called "Anvil Threat Corridor 1 .7". Inside the submenu, 
add three submenus for the three RAOB. 50 MHz. and Models data sources Each of the three submenus should have 
three product buttons 

- Add the nine shapefte product buttons (added in previous step) to the productButtonlnfo txt localization file 

- Add data keys for the nine shapeftes to the datalnfo manual localization file 

- Add depict keys for the nme shapefiles to the depictlnfo.manual localization file 

- Run the localization script with the +maps option Restart the D2D application 

- In the /awips/fxa/data directory, create soft links to the nine shapefiles in the /awjps/fxa/awjpsusr/AnvilTool directory 

- Copy the anviltool tel file to the /awips/fxa/bin/ directory Make sure that the file is executable. 


- Draw Linked Vectors opcode = 0x0100 Draw Unlinked Vectors opcode = 0x0200. 

- Draw Text: opcode = 0x0300. 

- Select Absolute Addressing opcode = OxOCTT (TT * FF for frame addressing. TT = 

00 for normal addressing; normal is the default) 

- Select Relative Addressing opcode = OxOO TT (TT = FF for frame addressing. TT = 00 
for normal addressing) 

- Set Frame Size opcode = OxOFgn (2° = size of frame) g = 1 for absolute coordinates 
in minutes of longitude/latitude, when g = 2. a central point is given in minutes and 
absolute coordinates refer to an offset from the central point in seconds of 
longitude/latitude 



Graphical overlay using KXMR raw insonde observation at 
1200 UTC on 7 March. 2007. The center local ion is the Shuttle 

Landing Faetey (SLF). The "Show Label At Ckcle" and "Show Graphical overlay of all nine shepefUee - three from profiler 
Label On Frame options are set to "Yea". data, three from rawlnsonde data, and three from model data. 



AMU TRAJECTORY MAP MAKER 

• Purpose: Overlay the ground trajectories of space vehicles during launch and landing on top of radar products 

• Potential Users: the 45th Weather Squadron and Spaceflight Meteorology Group 

• The tool plots trajectories using a text file of latitude/longitude points as input The text file can be in either Deorbit 
Opportunity (DOP) Map file format or Launch file format 

• DOP file format Each kne contains either a latitude/longitude pair or a blank line (east and north are positive) Sequential 
knes of latitude/longitude pairs are treated as a single knked vector A blank kne causes a new linked vector to start 

• Launch fte format: Three separate text files for each launch - for the left and right edges of the expected trajectory and 
the center of trajectory Each line contains three decimal numbers - the first is the altitude or time into the flight, the 
second is the latitude and the third is the longitude 

• Using the tool If the Data Type is set to DOP format, aD the files in DOP format are ksted in the FILES kstbox If the Data 
Type is set to Launch format, all the files in Launch format are listed The Map Type only determines the directory where 
the DGM fte will be stored - it does not affect the DGM fte format 

• How it works When the user selects a file in the FILES kstbox, the tool opens the input file for reading If the file is in the 
correct format, the DGM filename is created The frame size is written to the DGM fHe with the Set Frame Size command 
Either the Draw Linked Vectors or Draw Unlinked Vectors command is then written to the DGM file The number of points 
or pairs is written to the DGM file, followed by the longitude/latitude points or pairs Finally, the frame label, if selected, is 
written to the DGM file 


• Installation Instructions: 

- Copy the AMUmaptool tel and dgmfmt csh ftes to the /awips/fxa/bin directory. 

- Create the input directories to hold the input text files 

• /awips/fxa/awipsusr/AMUMapMaker/DOP 

• /awips/Txa/awipsusr/AMUMapMaker/Launch 

- Create the output directories to hold the DGM ftes: 

• /data/fxa/dg m/map/left 

• /data/fxa/dgm/map/nominal 

• /data/fxa/dgm/map/right 

• /data/fxa/dg m/map/landing 

- Add the tool to the $FXA_HOME/data/applnfo.txt localization file. 

- Add an application product button to the dataMenus txt localization file 

- In the backgroundMenus txt localization file, add a submenu called "Trajectory Maps' Inside the submenu add 
three product buttons: "Left Track". "Nominal Track", "Right Track", and "Shuttle Landing" 

- Add the three product buttons to the productButtonlnfo txt localization file 

- Add data keys for the three DGM products to the datalnfo. manual localization file. 

- Add depict keys for the three DGM products to the depictlnfo manual localization file. 

- Run the localization script with the default options Restart the D2D application 



Graphical ovarlay of launch trajacloriaa using all points 
Lines look jagged because horizontal resolution Is 
limited to minutes of latitude/ longitude 


Graphical overlay of launch factories using only the 
end points. 



ADVANTAGES OF DGM FILES 

• DGM files are easier to create than shapefiles 

• Unlike shapefiles, DGM files are not static and can be looped in D2D just like any other data product. 

• Unlike shapefiles, DGM ftes can be created directly in AWIPS. 

ADVANTAGES OF SHAPEFILES 

• There is pre-existing software that can be used to create or modify shapefiles 

• There is a large repository of shapeftes for use as maps, such as the AWIPS map database 

• The lines and points in a shapefile can be very precise since latitude/longitude points are stored with double-precision 
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